TERSE DEBUGGING PACKAGE 


STEP STEP NNNN I i 

PREPARE TO DEBUG VERB NAMED' NNNN. THE VERB ABOUT TO BE 
EXECUTED WILL BE PRINTED. 

S 

EXECUTE ONE INSTRUCTION C ONE PASS THROUGH THE INNER 
INTERPRETER ). * 

G 

EXECUTE THE ENTIRETY OF THE VERB ABOUT TO BE EXECUTED. 

Noire: G places The breakpoint pointer at the adr 2 + The 
interpreter pointer. Verbs that use the 2nd word as data or a 
Jump address < IF ELSE CASE LIT ) will not work. No actual 
change in the memory location is made ( PROM programs can be 
debugged this wa^j )* but note that the program is actual 1 
being stepped an instruction at a time when in G or 
breakpoint mode. 

PSD 

LIST THE CONTENTS OF THE entire PARAMETER STACK . 

RSD 

LIST THE CONTENTS OF THE entire RETURN STACK. 

BRK n BRK 

SET A BREAKPOINT AT THE SPECIFIED ADDRESS. 

Example: ' TESTPROG 1+ BRK 

Set a breakpoint at the "First instruction of TESTPROG C note 
skipping the header b^fte ). 

CLRBRK Clear breakpoint. 

VERB n VERB 

Display the name o*F the verb whose code start adr is n • Vervj 
ha nd>j ! 

UNCOM n UNCOM 

Uncompile ( list ) the verb compiled at adr n. 

' ' NNNN-n 

Return the begin of code adr of verb NNNN. C Part of system 
verbs > 
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INTERACTIVE DEBUGGER 


PS -n . " 3 *" 

Returns the value of -the parameter stack pointer < same as 
SP® >. 

RS -n 

Returns "the value of "the return stack pointer. 


FLAGS AND COUNTERS *** 

BM VARIABLE. BREAK MODE. 

0 - STOP EXECUTION ON ENCOUNTERING BREAKPOINT. 

1 - PRINT STATUS ON ENCOUNTERING BREAKPOINT AND CONTINUE 
EXECUTION. 

DFG VARIABLE. DISPLAY MODE FLAG. 

0 - NO DISPLAY AFTER INSTRUCTION EXECUTED. 

1 > DISPLAY ONLY INSTRUCTION TO BE EXECUTED. 

2 — Display parameter stack / verb about: to be executed; and 

top of return stack C I ) . ( 2 is default value ) 

DISPLAY FORMAT: 

C ... stktopvalue TVERB= NNNN C 1= h 1 

SCT Variable- Step count- Normally set to 0 - 

Set: to the number of* instructions to be executed before 
control returns to user. 

#EC Variable. Current interpreter pointer used b>d debugger. 

BFNT Variable. Adr where breakpoint is set. 

Variable. If breakpoint is set. Execution mode is 

breakpoint mode. A STEP or S will proceed until the BFNT @ is 

reached , 


SBRK 



